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Enums 


True if 1, else false 





DataType : Byte 
Double 
Float 
Int32 
Int64 
Boolean 
Variable 
String 
Instance 
Int16 = Ox0f 
InstanceType : Intl6 


StackTopOrGlobal 
Self = -1 

Other = -2 

All = -3 

Noone = -4 


Global = -5 
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L_ objectspecific //T£ it's none of the given values, 


VariableType : Byte 
Array 
StackTop = 0x80 
Normal = 0xa0 


Architecture 


Game Maker Language decompilation 


it represents a GameObjectIndex 


The interpreter is stack-based. Data is pushed and popped from the stack. 


Variables and arrays 


When parsing a Variable, if the Type is VariableType.Array: the index is at the stack top and has to be popped, and is followed by the Int16 -5, which 
also has to be popped. When an array is pushed and the Dup instruction occurs, the index is also duplicated. When Pop's or Push's InstanceType is 
InstanceType.StackTopOrGlobal, if Type is VariableType.StackTop then one additional value, representing the instance, will be popped from the 


stack. 


References 


Each ReferenceDefinition has a pointer to memory address of the first instruction that accesses it. In the second block of the instruction, there is the 
offset (calculated in blocks, not bytes) to the next occurrence of the reference. Note that the Type of the reference can change between different 


instances of said reference; for instance in one case an array item can be accessed, while in case the same array is accessed as a whole. Functions don't 


have a Type, only the offset to the next occurrence. 


Instructions 


Each instruction is composed of one or more 32-bit blocks. The most significant byte is the opcode. 


Reference 
Type : VariableType 
NextOccurrenceOffset : Int24 
Variable : Reference 
DoubleTypeInstruction 
Types : TypePair 
SingleTypeInstruction 
L Type : DataType 
GotoInstruction 
Loffset : Int24 


0x03: Conv : DoubleTypeInstruction //Push( (Types.Second) Pop) 
0x04: Mul : DoubleTypeInstruction //Push(Pop() * Pop()) 
0x05: Div : DoubleTypeInstruction //Push(Pop() / Pop()) 
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0x06: 
0x06: 
0x07: 
0x08: 
0x09: 
Ox0a: 
Ox0b: 
Ox0e: 
Ox1l1: 
0x12: 
Ox13: 
0x14: 
Ox15: 
Ox16: 
Ox41: 
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Rem : DoubleTypeInstruction //Push(Pop() % Pop()) 

Rem : DoubleTypeInstruction //Push(Remainder(Pop(), Pop())) 
Rem : DoubleTypeInstruction //Push(Pop() % Pop()) 

Add : DoubleTypeInstruction //Push(Pop() + Pop()) 

Sub : DoubleTypeInstruction //Push(Pop() - Pop()) 

And : DoubleTypeInstruction //Push(Pop() & Pop()) 

Or : DoubleTypeInstruction //Push(Pop() | Pop()) 

Not : DoubleTypeInstruction //Push(!Pop() ) 

Slt : DoubleTypeInstruction //Push(Pop() < Pop()) 

Sle : DoubleTypeInstruction //Push(Pop() <= Pop()) 

Seq : DoubleTypeInstruction //Push(Pop() == Pop()) 

Sne : DoubleTypeInstruction //Push(Pop() != Pop()) 

Sge : DoubleTypeInstruction //Push(Pop() >= Pop()) 

Sgt : DoubleTypeInstruction //Push(Pop() > Pop()) 

Pop //Instance.Destination = Pop(); //ATTENTION: if Types.First is Int32, the value will be on top of the stack, even 


before array access parameters! 
L Block1 


Instance : InstanceType 
Types : TypePair 


Block2 
_pestination : Variable 
0x82: Dup : SingleTypeInstruction //Push(Peek() ) 
Ox9d: Ret : SingleTypeInstruction //return Pop() 
Ox9e: Exit : SingleTypeInstruction //return; 
Ox9f: Popz : SingleTypeInstruction //Pop(); 
Oxb7: B : GotoInstruction //goto Index + Offset*4; 
Oxb8: Bt : GotoInstruction //if (Pop()) goto Index + Offset*4; 
Oxb9: Bf : GotoInstruction //if (!Pop()) goto Index + Offset*4; 
Oxbb: Pushenv : GotoInstruction 
Oxbc: Popenv : GotoInstruction 
OxcO: Push //Push(Value) 


Type : DataType 


Value : Variant //Depends on Type. Types longer than Int16 take one or more extra blocks. 


Instance type is an Intl6 in Blockl and the Reference is in Block2 


Oxda: 


Call //Function(argg, arg;, .--, Aargy,) where arg = Pop() and n = ArgumentsCount 


L Blockl 


ReturnType : DataType 
ArgumentsCount : Intl6 


Block2 
_ Function : Reference 


Oxff: 


Break //Invalid access guard? 


Type : DataType 
Signal : Int16 


After parsing 
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If you want to decompile the code in high level language, you'll have to do some structuring. Some graph theory is required to get good output. There 
are while, do..while, for loops and special Repeat statements (essentially For loops without declared variables); no improper loops, but breaks and 
continues. There are ifs, if..else's and switch..case's. Also considering that there are returns and exits, you'll have to heuristically simulate the stack and 
branch it when the control flow breaks. For any questions or if I've made mistakes, message me on Reddit. 


https://pcy.ulyssis.be/undertale/decompilation 4/4 


